home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmClipboardInquireCount.z / XmClipboardInquireCount
Encoding:
Text File  |  2003-11-18  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_C_l_i_p_b_o_a_r_d_I_n_q_u_i_r_e_C_o_u_n_t - A clipboard    function that returns
  10.       the number of    data item formats
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/Xm.h>
  14.       #include <Xm/CutPaste.h>
  15.  
  16.       int _X_m_C_l_i_p_b_o_a_r_d_I_n_q_u_i_r_e_C_o_u_n_t (ddddiiiissssppppllllaaaayyyy,,,,    wwwwiiiinnnnddddoooowwww,,,,    ccccoooouuuunnnntttt,,,,
  17.             mmmmaaaaxxxx____ffffoooorrrrmmmmaaaatttt____nnnnaaaammmmeeee____lllleeeennnnggggtttthhhh)
  18.            _D_i_s_p_l_a_y     **** ddddiiiissssppppllllaaaayyyy;
  19.            _W_i_n_d_o_w     wwwwiiiinnnnddddoooowwww;
  20.            _i_n_t     **** ccccoooouuuunnnntttt;
  21.            _u_n_s_i_g_n_e_d    _l_o_n_g**** mmmmaaaaxxxx____ffffoooorrrrmmmmaaaatttt____nnnnaaaammmmeeee____lllleeeennnnggggtttthhhh;
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.       _X_m_C_l_i_p_b_o_a_r_d_I_n_q_u_i_r_e_C_o_u_n_t returns the number of    data item
  25.       formats available for    the data item in the clipboard.     This
  26.       function also    returns    the maximum name-length    for all
  27.       formats in which the data item is stored.
  28.  
  29.       ddddiiiissssppppllllaaaayyyy
  30.            Specifies a pointer to the _D_i_s_p_l_a_y structure that was
  31.            returned    in a previous call to _X_O_p_e_n_D_i_s_p_l_a_y or
  32.            _X_t_D_i_s_p_l_a_y.
  33.  
  34.       wwwwiiiinnnnddddoooowwww
  35.            Specifies a widget's window ID that relates the
  36.            application window to the clipboard.  The widget's
  37.            window ID can be    obtained by using _X_t_W_i_n_d_o_w.  The same
  38.            application instance should pass    the same window    ID to
  39.            each of the clipboard functions that it calls.
  40.  
  41.       ccccoooouuuunnnntttt
  42.            Returns the number of data item formats available for
  43.            the data    item in    the clipboard.    If no formats are
  44.            available, this argument    equals zero.  The count
  45.            includes    the formats that were passed by    name.
  46.  
  47.       mmmmaaaaxxxx____ffffoooorrrrmmmmaaaatttt____nnnnaaaammmmeeee____lllleeeennnnggggtttthhhh
  48.            Specifies the maximum length of all format names    for
  49.            the data    item in    the clipboard.
  50.  
  51.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  52.       _C_l_i_p_b_o_a_r_d_S_u_c_c_e_s_s
  53.            The function is successful.
  54.  
  55.       _C_l_i_p_b_o_a_r_d_L_o_c_k_e_d
  56.            The function failed because the clipboard was locked by
  57.            another application.  The application can continue to
  58.            call the    function again with the    same parameters    until
  59.            the lock    goes away.  This gives the application the
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.            opportunity to ask if the user wants to keep trying or
  75.            to give up on the operation.
  76.  
  77.       _C_l_i_p_b_o_a_r_d_N_o_D_a_t_a
  78.            The function could not find data    on the clipboard
  79.            corresponding to    the format requested.  This could
  80.            occur because the clipboard is empty; there is data on
  81.            the clipboard but not in    the requested format; or the
  82.            data in the requested format was    passed by name and is
  83.            no longer available.
  84.  
  85.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  86.       _X_m_C_l_i_p_b_o_a_r_d_S_t_a_r_t_C_o_p_y(_3_X).
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.